# Replication Data Documentation

**Dataset:** Fork, David; Wesley, Elizabeth (2025). *Replication Data for: Estimating high-resolution albedo for urban applications.*  
**Repository:** Harvard Dataverse  
**DOI:** https://doi.org/10.7910/DVN/7T7QDH  
**UNF:** 6:d3hhTCPskQpSdVikD1lFsg==  

---

## 1. Overture Building Footprints (Boulder, CO)

**Filenames**
- 2023-05-23_PNeo_co_boulder_2023-05-23_17-55-42_overture_samples_flight_lines.tab
- 2023-05-23_PNeo_co_boulder_2023-05-23_17-56-10_overture_samples_flight_lines.tab
- 2024-05-08_PNeo_co_boulder_2024-05-08_17-55-11_overture_samples_flight_lines.tab
- 2024-05-16_PNeo_co_boulder_2024-05-16_17-58-54_overture_samples_flight_lines.tab
- 2024-05-16_PNeo_co_boulder_2024-05-16_17-59-05_overture_samples_flight_lines.tab

**Column Definitions**
- system:index — ID column.
- NEON_albedo_mean — Mean building footprint albedo from NEON.
- NEON_albedo_median — Median building footprint albedo from NEON.
- NEON_albedo_stdDev — Standard deviation of building footprint albedo from NEON.
- NEON_solar_azimuth_mode — Mode of solar azimuth from NEON flightlines.
- NEON_solar_azimuth_stdDev — Standard deviation of solar azimuth from NEON flightlines.
- NEON_solar_elevation_mode — Mode of solar elevation from NEON flightlines.
- NEON_solar_elevation_stdDev — Standard deviation of solar elevation from NEON flightlines.
- PNeo_albedo_mean — Mean building footprint albedo from downscaled (PNeo) estimates.
- PNeo_albedo_median — Median building footprint albedo from downscaled (PNeo) estimates.
- PNeo_albedo_stdDev — Standard deviation of building footprint albedo from downscaled (PNeo) estimates.
- S2_albedo_mean — Mean building footprint albedo from Sentinel-2.
- S2_albedo_median — Median building footprint albedo from Sentinel-2.
- S2_albedo_stdDev — Standard deviation of building footprint albedo from Sentinel-2.
- class (from Overture Maps) — Built purpose (e.g., apartments, office, warehouse).
- facade_color (facade_col) (from Overture Maps) — Facade color (hex or named color).
- facade_material (facade_mat) (from Overture Maps) — Facade’s outer surface material.
- has_parts (from Overture Maps) — Boolean flag; building has associated building_part features.
- height (from Overture Maps) — Height in meters (lowest to highest point).
- id (from Overture Maps) — Overture feature ID; may also link to GERS.
- is_underground (is_undergr) (from Overture Maps) — Building is completely below ground.
- level (from Overture Maps) — Z-order stacking index (0 = ground level).
- min_floor (from Overture Maps) — Starting floor index if building begins above ground.
- names (from Overture Maps) — Structured names (primary, common, localized).
- num_floors_underground (num_floo_1) (from Overture Maps) — Number of below-ground floors.
- num_floors (from Overture Maps) — Number of above-ground floors.
- roof_color (from Overture Maps) — Roof color (hex or named color).
- roof_material (roof_mater) (from Overture Maps) — Outermost roof material.
- roof_shape (from Overture Maps) — Roof shape (e.g., flat, gabled, hipped).
- sources (from Overture Maps) — Provenance array (property, dataset, confidence).
- subtype (from Overture Maps) — Broad building category/purpose (e.g., residential, commercial, industrial, civic).
- version (from Overture Maps) — Integer version; increments whenever the feature’s geometry or attributes change.
- .geo — Geometry column.

---

## 2. Minimum Zenith Angle (NEON Flightlines × Overture Footprints)

**Filenames**
- overture-boulder-min-zenith.geojson

**Column Definitions**
- flight_line — NEON flightline ID.  
- id — Building footprint ID.  
- med_alb — Median albedo from NEON.  
- solarZenith — Minimum solar zenith angle from NEON flightlines intersecting the building footprint.  

---

## 3. City Boundaries

**Filenames**
- City_Medians_water_masked.tab

**Column Definitions**
- system:index — Geometry column.  
- albedo — Median albedo from Sentinel-2.  
- area — Area of the city boundary in square meters.  
- city — City name.  
- crs — Projection.  
- .geo — Geometry column.  

---

## 4. NEON Albedo (Boulder Flightlines)

**Filenames (GeoTIFF raster images)**
- NEON_calibrationFlight_Boulder2024_L001.tif  
- NEON_calibrationFlight_Boulder2024_L002.tif  
- …  
- NEON_calibrationFlight_Boulder2024_L018.tif  

(Each file contains albedo estimates from a NEON calibration flightline.)  

---

## 5. Overture Buildings from Global Cities (with Albedo Estimates)

**Filenames**
- almeria_overture_aggregation.tab  
- athens_overture_aggregation.tab  
- boston_overture_aggregation.tab  
- buenos-aires_overture_aggregation.csv  
- durban_overture_aggregation.tab  
- hyderabad_overture_aggregation.csv  
- los-angeles_overture_aggregation.csv  
- melbourne_overture_aggregation.tab  
- mexico-city_overture_aggregation.csv  
- patna_overture_aggregation.tab  
- phoenix_overture_aggregation.csv  
- washington_overture_aggregation.tab  

**Column Definitions**
- ovrtr_d — ID column from Overture Maps.  
- PNeo — Median albedo from downscaled (PNeo) estimates.  
- S2 — Median albedo from Sentinel-2.  
- PNeo_delta — Difference between PNeo and cool roof albedo of 0.55.  
- S2_delta — Difference between S2 and cool roof albedo of 0.55.  
- geometry — Geometry column.  
- area — Building footprint area (m²).  
- PNeo_eff_area — PNeo_delta × area.  
- S2_eff_area — S2_delta × area.  
- city — City name.  

---

## 6. Metadata for Downscaled Albedo (PNeo), Sentinel-2, and NEON

**Filenames**
- metadata_roofsegments_PNeoDate_2023-05-23_17-55-42.tab  
- metadata_roofsegments_PNeoDate_2023-05-23_17-56-10.tab  
- metadata_roofsegments_PNeoDate_2024-05-08_17-55-11.tab  
- metadata_roofsegments_PNeoDate_2024-05-16_17-58-54.tab  
- metadata_roofsegments_PNeoDate_2024-05-16_17-59-05.tab  

**Column Definitions**
- system:index — ID column.  
- NEON_flight_ID — NEON flightline ID.  
- PNeo_cal_middate — Date of PNeo imagery used.  
- PNeo_date_string — Date and time of PNeo imagery used.  
- S2_MEAN_INCIDENCE_AZIMUTH_ANGLE_B4 — Mean incidence azimuth angle from Sentinel-2 band 4 (100-day window).  
- S2_MEAN_INCIDENCE_ZENITH_ANGLE_B4 — Mean incidence zenith angle from Sentinel-2 band 4 (100-day window).  
- S2_MEAN_SOLAR_AZIMUTH_ANGLE — Mean solar azimuth from Sentinel-2 (100-day window).  
- S2_MEAN_SOLAR_ZENITH_ANGLE — Mean solar zenith from Sentinel-2 (100-day window).  
- S2_mid_date_for_median — Middate of the 100-day window for Sentinel-2 imagery.  
- imager — Imager type (PNeo, Sentinel-2, NEON).  
- satelliteAzimuthAngleMean — Satellite azimuth angle (PNeo).  
- satelliteElevationAngleMean — Satellite elevation angle (PNeo).  
- solarAzimuth — Solar azimuth from NEON flightline.  
- solarAzimuthAngle — Solar azimuth from PNeo image.  
- solarElevationAngle — Solar elevation from PNeo image.  
- solarZenith — Solar zenith from NEON flightline.  
- .geo — Geometry column.  

---

## 7. Roof Segments (Boulder, CO)

**Filenames**
- roofsegments_PNeoDate_2023-05-23_17-55-42.tab  
- roofsegments_PNeoDate_2023-05-23_17-56-10.tab  
- roofsegments_PNeoDate_2024-05-08_17-55-11.tab  
- roofsegments_PNeoDate_2024-05-16_17-58-54.csv  
- roofsegments_PNeoDate_2024-05-16_17-59-05.tab  

**Column Definitions**
- system:index — ID column.  
- Columns beginning with `NEON_*` — Format: `NEON_flightlineId_albedo_statistic`  
  - *flightlineId* = NEON flightline ID.  
  - *statistic* = one of {mean, median, stdDev}.  
- Columns beginning with `PNeo_*` — Format: `PNeo_PNeoImageDate_cal_Sentinel2Date_method_albedo_statistic`  
  - *PNeoImageDate* = Date/time of PNeo image used.  
  - *Sentinel2Date* = Calibration date (single or 100-day composite).  
  - *method* = One of {reprojected, unreprojected calibration transfer, unreprojected}.  
  - *statistic* = one of {mean, median, stdDev}.  
- Columns beginning with `S2_*` — Format: `S2_PNeoImageDate_cal_Sentinel2Date_method_albedo_statistic`  
  - Same definitions as PNeo columns.  
- ids — ID of the roof from which the segment was derived.  
- roof_area_m2 — Area of the roof (not the segment) in m².  
- segment_azimuth — Azimuth of the roof segment.  
- segment_pitch — Pitch (slope) of the roof segment.  
- .geo — Geometry column.  
